Stone Extension Library Release 1.0  Copyright ã1992 by Stone Design, Inc.  All Rights Reserved.

DebugMethodClass

Inherits From:	Object

Declared In:	3DDebugUtilities/DebugMethods.h

Class Description

DebugMethodClass is a simple class that is designed to be customized by a developer.  It contains no instance variables and only one method by default;  +initMenu.  The DebugMethodClass is the basic building block through which the developer can add their own debugging functionality to 3DReality.

The bundle containing the DebugMethodClass (and any other functionality the developer may have added) is dynamically loaded during the initialization/loading of 3DReality.  If the application is either in debugging mode (see «that damned debugging document that I haven't written yet») or the application is named 3DReality.debug (instead of 3DReality.app), then the 3DDebugUtilities bundle will be automatically loaded during 3DReality's launch.  When the bundle is loaded, the initMenu method will be called.  At that point in time, the module can do anything it needs to to initialize itself.

The example/template module provided with the SEL does nothing more than initialize the debugging menu with some basic functionality provided via a couple of Categories to the Camera class.  In that template, the DebugMethodClass is never even instantiated-- the initMenu method implements all of the intialization needed.

Instance Variables

No instance variables defined in DebugMethodClass

Method Types

Intialization	+ initMenu

Class Methods

initMenu
+ initMenu

Initializes the debugging menu within the 3DReality application.  It does this by programatically creating a new menu, adding whatever items it needs to that menu (and assigning to appropriate target/actions to those items) and then adding the new menu to the debugging menu as a sub-menu.

To customize the debugging modules behaviour, the developer should reimplement this method however they need-- this includes potentially instantiating an instance of the DebugMethodClass class (or any other class).

See also:  «debugging documentation»